###Function###
FileWriteLine

###Description###
Fgt eine Zeile Text an das Ende einer zuvor geffneten Textdatei.

###Syntax###
FileWriteLine ( "filehandle/filename", "line" )


###Parameters###
@@ParamTable@@
filehandle/filename
	Das Handle der Datei, wie es von einem frheren Aufruf von <a href="FileOpen.htm">FileOpen()</a> zurckgegeben wurde. Alternativ kann ein String mit dem Dateinamen als erster Parameter verwendet werden.
line
	Die Textzeile, die in die Datei geschrieben werden soll. Wenn die Zeile NICHT mit @CR oder @LF endet, dann wird automatisch ein MS-DOS-Zeilenvorschub (@CRLF) angefgt.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	1.
Fehler:	0 wenn die Datei nicht im writemode geffnet ist, die Datei schreibgeschtzt ist oder aus anderen Grnden nicht beschrieben werden konnte.
@@End@@


###Remarks###
Die Datei muss im Schreibmodus (write mode) geffnet sein, damit <a href="FileWriteLine.htm">FileWriteLine()</a> keinen Fehler hervorruft.

Wenn ein Dateiname statt eines Dateihandles angegeben wird, wird die Datei whrend des Funktionsaufrufes geffnet und geschlossen. Wenn man groe Textdateien bearbeitet, ist das natrlich viel langsamer als die Arbeit mit Handles. Die Datei wird erstellt, wenn sie noch nicht existiert.

Hinweis: Die Verwendung von Dateihandles und -namen sollte nicht vermischt werden. So sollte man z.B. vermeiden, eine Datei mit <a href="FileOpen.htm">FileOpen()</a> zu ffnen und dann in dieser Funktion einen Dateinamen verwenden. Es sind entweder Handles oder Dateinamen zu benutzen - nicht beides.

AutoIt schreibt Text standardmig mit ANSI Kodierung. Um in Unicode Kodierung zu schreiben, muss die Datei mit <a href="FileOpen.htm">FileOpen()</a> unter Verwendung der notwendigen Flags geffnet werden.

Der zu Schreibende Text kann keine <a href="Chr.htm">Chr</a>(0) Zeichen enthalten, da die Ausgabe sonst beschnitten wird. <a href="FileWrite.htm">FileWrite()</a> mit einer Datei die im Binrmodus geffnet wurde, kann solche Zeichen schreiben.

Mit der Funktion _FileWriteToLine kann man auch an einer ganz bestimmten Stelle in einer Datei schreiben (z. B. an den Anfang der Datei)


###Related###
FileFlush, FileOpen, FileRead, FileReadLine, FileWrite, FileSetPos, FileGetPos


###Example###
@@IncludeExample@@
